HarnessAPI: A Skill-First Framework for Unified Streaming APIs and MCP Tools
HarnessAPI:技能优先的统一流式API与MCP工具框架
🧭 Agent 工具部署与统一API框架
Western Michigan University
从单一技能文件夹自动派生流式HTTP端点、OpenAPI UI和MCP工具,减少74%样板代码
📌 工作参考价值(4 点)
- 单源技能定义:借鉴“技能文件夹 + Pydantic schema”模式,为每个业务能力(如推荐召回、订单查询)设置单一事实源,自动导出HTTP端点和MCP工具,避免双重维护,降低Agent工具与人工接口的偏离风险。
- 双模响应协商:同一handler通过Content-Type自动切换SSE流式与JSON响应,适合生成式推荐中流式生成结果与常规RPC调用,无需重写业务逻辑。
- 全生态继承:HarnessAPI子类化FastAPI,可直接复用现有中间件、依赖注入、鉴权和部署方案,工程落地成本低,适合在已有FastAPI服务上快速增加MCP工具暴露。
- 动态代码生成保型:通过动态生成模块确保Pydantic类型注解在MCP工具层正确传递,解决闭包注册时的类型丢失问题,对需要强类型校验的Agent工具链(如电商API参数校验)至关重要。